home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / Dev / Lisp / 68020 / clisp.man < prev    next >
Text File  |  1995-08-25  |  5KB  |  149 lines
  1. Amiga user manual                                    Amiga user manual
  2.  
  3. NAME
  4.      clisp - Common Lisp language interpreter and compiler
  5.  
  6. SYNOPSIS
  7.      clisp [ -h ] [ -m memsize ] [ -s stacksize ] [ -M memfile  ]
  8.      [ -q ] [ -i initfile ...  ] [ -c [ -l ] lispfile ...  ] [ -x
  9.      expression ]
  10.  
  11. DESCRIPTION
  12.      Invokes the common lisp interpreter and  compiler.   Invoked
  13.      without arguments, executes a read-eval-print loop, in which
  14.      expressions are in turn read from standard input,  evaluated
  15.      by  the  lisp interpreter, and their results output to stan-
  16.      dard output.  Invoked with -c, the specified lisp files  are
  17.      compiled  to  a  bytecode  that  can  be executed more effi-
  18.      ciently.
  19.  
  20. OPTIONS
  21.      -h   Displays a help message on how to use clisp.
  22.  
  23.      -m memsize
  24.           Sets the amount  of  memory  clisp  tries  to  grab  on
  25.           startup.   The amount may be given as nnnnnnn (measured
  26.           in bytes), nnnnK or nnnnKB (measured in  kilobytes)  or
  27.           nM  or nMB (measured in megabytes).  Default is 2 mega-
  28.           bytes.  The argument is constrained between 100 KB  and
  29.           16  MB.   --  This  version  of  clisp allocates memory
  30.           dynamically.  memsize is essentially ignored.
  31.  
  32.      -s stacksize
  33.           Sets the size of the stack clisp allocates for  itself.
  34.           The  syntax is the same as for memsize.  Default is one
  35.           eighth of memsize.  The argument is constrained between
  36.           40 KB and 8 MB.
  37.  
  38.      -M memfile
  39.           Specifies the initial memory image.   This  must  be  a
  40.           memory dump produced by the saveinitmem function.
  41.  
  42.      -q   Quiet: clisp displays  no  banner  at  startup  and  no
  43.           good-bye message when quitting.
  44.  
  45.      -i initfile ...
  46.           Specifies initialization files to be loaded at startup.
  47.           These should be lisp files (source or compiled).
  48.  
  49.      -c lispfile ...
  50.           Compiles the specified lispfiles to bytecode. The  com-
  51.           piled  files  can then be loaded instead of the sources
  52.           to gain efficiency.
  53.  
  54.      -l   A bytecode listing of the files being compiled will  be
  55.           produced.  Useful only for debugging purposes.
  56.  
  57.      -x expressions
  58.           Executes a series of arbitrary expressions instead of a
  59.           read-eval-print  loop.   The  values of the expressions
  60.           will be output to standard output.  Due to the argument
  61.           processing  done  by the shell, the expressions must be
  62.           enclosed  in  single  quotes,  and  double  quotes  and
  63.           backslashes must be preceded by backslashes.
  64.  
  65. WORKBENCH
  66.      Two kinds of tooltypes are supported:
  67.  
  68.      WINDOW= windowspec
  69.           clisp will communicate with the console window or  pipe
  70.           specified by windowspec.
  71.  
  72.      ARGS= arguments
  73.           Specifies the command line arguments for clisp.  Within
  74.           arguments  the  token  `*'  may  be  used to denote the
  75.           project's filename.  arguments defaults to `-i *' which
  76.           means that the file will be loaded (see above).
  77.  
  78. REFERENCE
  79.      The language implemented conforms to
  80.             Guy L. Steele Jr.: Common Lisp - The Language.
  81.             Digital Press. 1st edition 1984, 465 pages.
  82.             ("CLtL1" for short)
  83.      and to the older parts of
  84.             Guy L. Steele Jr.: Common Lisp - The Language.
  85.             Digital Press. 2nd edition 1990, 1032 pages.
  86.             ("CLtL2" for short)
  87.  
  88. USE
  89.      help to get some on-line help.
  90.  
  91.      (apropos name)
  92.           lists the symbols relating to name.
  93.  
  94.      (exit) or (quit) or (bye)
  95.           to quit clisp.
  96.  
  97.      EOF (Ctrl-\)
  98.           to leave the current read-eval-print loop.
  99.  
  100. FILES
  101.      lisp.run
  102.           main executable
  103.  
  104.      lispinit.mem
  105.           initial memory image
  106.  
  107.      config.lsp
  108.           site-dependent configuration
  109.  
  110.      *.lsp
  111.           lisp source
  112.  
  113.      *.fas
  114.           lisp code, compiled by clisp
  115.  
  116.      *.lib
  117.           lisp source library information, generated and used  by
  118.           the clisp compiler
  119.  
  120. ENVIRONMENT
  121. SEE ALSO
  122.      cmulisp(1), emacs(1).
  123.  
  124. BUGS
  125.      The function inspect is not implemented.
  126.  
  127.      Only very few extensions from CLtL2 are supported.
  128.  
  129.      No on-line documentation  beyond  apropos  and  describe  is
  130.      available.
  131.  
  132. PROJECTS
  133.      Writing on-line documentation.
  134.  
  135.      Building a foreign function interface  (ability  to  call  C
  136.      code directly).
  137.  
  138.      Write inspect.
  139.  
  140.      Enhance the compiler such that it  can  inline  local  func-
  141.      tions.
  142.  
  143.      Specify a portable set of window and graphics operations.
  144.  
  145. AUTHORS
  146.      Bruno Haible <haible@ma2s2.mathematik.uni-karlsruhe.de>  and
  147.      Michael Stoll.
  148.  
  149.